package org.example.friend_test.mapper;

import org.example.friend_test.entity.Friend;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 朋友数据访问层接口
 */
@Mapper
public interface FriendMapper {
    
    /**
     * 根据用户ID查找所有朋友
     * 
     * @param userId 用户ID
     * @return 朋友列表
     */
    List<Friend> selectByUserId(@Param("userId") Long userId);
    
    /**
     * 根据ID查找朋友
     * 
     * @param id 朋友ID
     * @return 朋友对象
     */
    Friend selectById(@Param("id") Long id);
    
    /**
     * 根据姓名和用户ID查找朋友
     * 
     * @param name 姓名
     * @param userId 用户ID
     * @return 朋友列表
     */
    List<Friend> selectByNameAndUserId(@Param("name") String name, @Param("userId") Long userId);
    
    /**
     * 根据关系和用户ID查找朋友
     * 
     * @param relationship 关系
     * @param userId 用户ID
     * @return 朋友列表
     */
    List<Friend> selectByRelationshipAndUserId(@Param("relationship") String relationship, @Param("userId") Long userId);
    
    /**
     * 插入新朋友
     * 
     * @param friend 朋友对象
     * @return 影响的行数
     */
    int insert(Friend friend);
    
    /**
     * 更新朋友信息
     * 
     * @param friend 朋友对象
     * @return 影响的行数
     */
    int update(Friend friend);
    
    /**
     * 根据ID删除朋友
     * 
     * @param id 朋友ID
     * @return 影响的行数
     */
    int deleteById(@Param("id") Long id);
    
    // 兼容旧版本的方法
    /**
     * 查找所有朋友（已废弃，请使用selectByUserId）
     * 
     * @return 朋友列表
     * @deprecated 请使用 selectByUserId(Long userId)
     */
    @Deprecated
    List<Friend> findAll();
    
    /**
     * 根据姓名查找朋友（已废弃，请使用selectByNameAndUserId）
     * 
     * @param name 姓名
     * @return 朋友列表
     * @deprecated 请使用 selectByNameAndUserId(String name, Long userId)
     */
    @Deprecated
    List<Friend> findByName(@Param("name") String name);
    
    /**
     * 根据关系查找朋友（已废弃，请使用selectByRelationshipAndUserId）
     * 
     * @param relationship 关系
     * @return 朋友列表
     * @deprecated 请使用 selectByRelationshipAndUserId(String relationship, Long userId)
     */
    @Deprecated
    List<Friend> findByRelationship(@Param("relationship") String relationship);
}
